Summary

• rename the IoT asset registry detail tool from get_asset_detail(site_name, asset_id) to asset_detail(site_name, asset_id)
• add find_assets_by_sensors(site_name, sensors, match="all", substring=false, source="measured") to find site-registered assets by installed registry sensors or measured telemetry fields
• add structured FindAssetsResult / AssetSensorMatch responses with the deduplicated query sensors and concrete matched sensor names per asset
• preserve existing registry/telemetry separation: asset_detail, assets, and installed_sensors read from asset_db; measured_sensors and find_assets_by_sensors(source="measured") read telemetry fields from iot_db
• deduplicate repeated sensor query terms before match="all" evaluation while preserving first occurrence order
• update README, MCP server docs, and tool docstrings to describe the current IoT tool surface and find_assets_by_sensors behavior
• add unit coverage for tool registration, renamed asset_detail, installed/measured sensor source behavior, substring matching, and duplicate query sensor handling

Tool Surface

• sites() -> {"sites": [...]}
• asset_ids(site_name) -> bare asset id list for the site
• asset_detail(site_name, asset_id) -> asset registry details: site_name, asset_id, description, assettype, status, location, installdate, vintage, n_installed_sensors, message
• assets(site_name, assettype?) -> asset metadata rows: asset_id, description, assettype, vintage, n_sensors
• installed_sensors(site_name, asset_id) -> registry sensor inventory for an asset from asset_db
• measured_sensors(site_name, asset_id) -> observed telemetry field names for an asset from iot_db
• find_assets_by_sensors(site_name, sensors, match?, substring?, source?) -> assets whose installed or measured sensors match the query

find_assets_by_sensors Behavior

• source="installed" searches each asset record's registry sensors inventory
• source="measured" searches telemetry field names discovered from IoT records
• match="all" requires every deduplicated query sensor to match
• match="any" requires at least one deduplicated query sensor to match
• substring=true performs case-insensitive substring matching
• duplicate query sensors are collapsed in query_sensors and do not cause false negatives for match="all"

Tests

• uv run --frozen pytest src/servers/iot/tests/test_tools.py (31 passed)
• /tmp/aob_find_assets_by_sensors_smoke.py real-db smoke via PYTHONPATH=src uv run --frozen python /tmp/aob_find_assets_by_sensors_smoke.py
  • installed exact and substring searches returned expected assets
  • duplicate query search returned deduped query_sensors
  • measured exact and substring searches returned expected assets
  • invalid match, invalid source, empty sensors, and no-match cases returned expected responses